home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Serious Demos / XTension demo / XTension manual 2.0 / XTension manual 2.0.rsrc / TEXT_156.txt < prev    next >
Text File  |  1998-07-18  |  3KB  |  72 lines
  1. Human Interface Verbs :  
  2.  
  3. write log: Write a timestamped message to the log file 
  4.  write log  string  -- message to log
  5.         [color  black/blue/green/red]  -- Set color of the text to : Black, Blue, Green, Red
  6.     example :  write log "Motion detected in the garage"
  7.  
  8. This verb provides the ability of any script to write a timestamped message to the log file, as well as a Colored entry to the Log Window.
  9.  
  10.  
  11. alert user: Display a dialog for the user
  12.  alert user  string  -- Message to place in the dialog
  13.     example :  alert user "Glass breakage in the Dining  Room"
  14.  
  15. This verb allows any script to display a human-response-required dialog on the host screen.
  16. This means that a human must hit 'OK' and acknowledge the event before the notice is cleared.
  17. This is a special dialog which will not interfere with other Mac functions.
  18.  
  19. Also, multiple alerts may be 'stacked' on screen until acknowledged.
  20. Alert user should not be used but for events which you want to make sure someone 'sees'.
  21.  
  22. PS:  don't confuse this verb with the utility program "Alert User" ...
  23.  
  24.  
  25. get input: Request input from the user
  26.         get input  string  -- dialog box prompt
  27.         Result:   string  -- returned string  (Maximum 32 characters at a time)
  28.         example :  display dialog (get input "Enter your Password:")
  29.  
  30.  
  31. display dialog: Display a dialog for the user
  32.         display dialog  string  -- text to display
  33.         example :  display dialog "There is a Fire in the  Basement"
  34. NOTE:  this special verb creates a NON-modal dialog --it won't stop XTension
  35.  
  36. speak: Use the Macintosh speech synthesizer to speak a  message
  37.  speak  string  -- Message to speak
  38.     example :  speak "There is a FIRE in the GARAGE"
  39.  
  40. This verb will call upon the Macintosh speech module to annunciate the given string.
  41. NOTE:  this special verb creates a NON-modal dialog --it won't stop XTension
  42.  
  43. front window: Bring a specified window to the front
  44.         front window  string  -- window name
  45.         example :  front window "Master List"
  46.  
  47. This verb is used to bring one of the XTension windows to the front.  Used in conjunction with the highlight unit verb, it can be used to point out a specific unit in any View or List.
  48.  
  49.  
  50. hide window: Hide a named window if it is visible
  51.         hide window  string  -- window name
  52.         example :  hide window "Master List"
  53.  
  54. This verb is used in conjunction with the 'front window' verb for just the obvious reason.
  55.  
  56.  
  57. highlight unit: Selects a unit in the front window
  58.         highlight unit  string  -- unit name
  59.         example :  front window "Master List"
  60.                 highlight unit "Foyer Light"
  61.  
  62. This verb will cause any database unit in the front window to be selected.  In a View, the icon for the unit is selected, and the name is displayed below the icon.
  63.  
  64.  
  65. set logging:  Sets the level of detail displayed in the Log Window
  66.         set logging  string  -- "all"  "normal" or "exceptions"
  67.         example :  set logging "all"
  68.   
  69.  
  70. This verb will change the current logging detail preferences to the desired level of detail.  "All" of course will cause every event to be written to the Log Window, and "exceptions" will limit the detail to only errors or explicit 'write log' events.
  71.  
  72.